home *** CD-ROM | disk | FTP | other *** search
/ Games of Daze / Infomagic - Games of Daze (Summer 1995) (Disc 1 of 2).iso / djgpp / contrib / pdcurs22 / src / portable / insstr.c < prev    next >
Encoding:
C/C++ Source or Header  |  1995-01-26  |  7.1 KB  |  228 lines
  1. /*
  2. ***************************************************************************
  3. * This file comprises part of PDCurses. PDCurses is Public Domain software.
  4. * You may use this code for whatever purposes you desire. This software
  5. * is provided AS IS with NO WARRANTY whatsoever.
  6. * Should this software be used in another application, an acknowledgement
  7. * that PDCurses code is used would be appreciated, but is not mandatory.
  8. *
  9. * Any changes which you make to this software which may improve or enhance
  10. * it, should be forwarded to the current maintainer for the benefit of 
  11. * other users.
  12. *
  13. * The only restriction placed on this code is that no distribution of
  14. * modified PDCurses code be made under the PDCurses name, by anyone
  15. * other than the current maintainer.
  16. * 
  17. * See the file maintain.er for details of the current maintainer.
  18. ***************************************************************************
  19. */
  20. #define    CURSES_LIBRARY    1
  21. #include <curses.h>
  22.  
  23. /* undefine any macros for functions defined in this module */
  24. #undef    insstr
  25. #undef    insnstr
  26. #undef    winsstr
  27. #undef    winsnstr
  28. #undef    mvinsstr
  29. #undef    mvinsnstr
  30. #undef    mvwinsstr
  31. #undef    mvwinsnstr
  32.  
  33. /* undefine any macros for functions called by this module if in debug mode */
  34. #ifdef PDCDEBUG
  35. #  undef    move
  36. #  undef    wmove
  37. #  undef    addch
  38. #  undef    waddch
  39. #endif
  40.  
  41. #ifdef PDCDEBUG
  42. char *rcsid_insstr  = "$Id$";
  43. #endif
  44.  
  45. /*man-start*********************************************************************
  46.  
  47.   Name:                                                        insstr
  48.  
  49.   Synopsis:
  50.       int insstr(char *str);
  51.       int insnstr(char *str, int n);
  52.       int winsstr(WINDOW *win, char *str);
  53.       int winsnstr(WINDOW *win, char *str, int n);
  54.       int mvinsstr(int y, int x, char *str);
  55.       int mvinsnstr(int y, int x, char *str, int n);
  56.       int mvwinsstr(WINDOW *, int y, int x, char *str);
  57.       int mvwinsnstr(WINDOW *, int y, int x, char *str, int n);
  58.  
  59.   System V Curses Description:
  60.       With these routines, a character string (as many characters as 
  61.       will fit on the line) is inserted before the character under 
  62.       the cursor.  All characters to the right of the cursor are moved 
  63.       to the right, with the possibility of the rightmost characters 
  64.       on the line being lost.  The cursor position does not change 
  65.       (after moving to y,x if specified).  The four routines with n as 
  66.       the last argument insert at most n characters.  If n<=0, then 
  67.       the entire string is inserted.
  68.  
  69.      NOTE:    insstr(), mvinsstr(), and mvwinsstr() are implemented as macros.
  70.          insnstr(), mvinsnstr(), and mvwinsnstr() are implemented as macros.
  71.  
  72.   PDCurses Description:
  73.      The *raw*() routines output 8 bit values.  These contrast to their
  74.      normal counterparts which output 7 bit values and convert control
  75.      character to the ^X notation.
  76.  
  77.      str is a standard 8 bit character string WITHOUT embedded attributes.
  78.  
  79.   X/Open Return Value:
  80.      All functions return OK on success and ERR on error.
  81.  
  82.   X/Open Errors:
  83.      No errors are defined for this function.
  84.  
  85.   Portability                             X/Open    BSD    SYS V
  86.                                           Dec '88
  87.       insstr                                -        -      4.0
  88.       winsstr                               -        -      4.0
  89.       mvinsstr                              -        -      4.0
  90.       mvwinsstr                             -        -      4.0
  91.       insnstr                               -        -      4.0
  92.       winsnstr                              -        -      4.0
  93.       mvinsnstr                             -        -      4.0
  94.       mvwinsnstr                            -        -      4.0
  95.  
  96. **man-end**********************************************************************/
  97.  
  98. /***********************************************************************/
  99. int    insstr(char *str)
  100. /***********************************************************************/
  101. {
  102. #ifdef PDCDEBUG
  103.     if (trace_on) PDC_debug("insstr() - called: string=\"%s\"\n",str);
  104. #endif
  105.  
  106.     if (stdscr == (WINDOW *)NULL)
  107.         return( ERR );
  108.  
  109.     return(winsnstr(stdscr,str,(-1)));
  110. }
  111. /***********************************************************************/
  112. int    insnstr(char *str, int n)
  113. /***********************************************************************/
  114. {
  115. #ifdef PDCDEBUG
  116.     if (trace_on) PDC_debug("insnstr() - called: string=\"%s\" n %d \n",str,n);
  117. #endif
  118.  
  119.     if (stdscr == (WINDOW *)NULL)
  120.         return( ERR );
  121.  
  122.     return(winsnstr(stdscr,str,n));
  123. }
  124. /***********************************************************************/
  125. int    winsstr(WINDOW *win, char *str)
  126. /***********************************************************************/
  127. {
  128. #ifdef PDCDEBUG
  129.     if (trace_on) PDC_debug("winsstr() - called: string=\"%s\"\n",str);
  130. #endif
  131.  
  132.     if (win == (WINDOW *)NULL)
  133.         return( ERR );
  134.  
  135.     return(winsnstr(win,str,(-1)));
  136. }
  137. /***********************************************************************/
  138. int    winsnstr(WINDOW *win, char *str, int n)
  139. /***********************************************************************/
  140. {
  141.     int ic = strlen(str);
  142.  
  143. #ifdef PDCDEBUG
  144.     if (trace_on) PDC_debug("winsnstr() - called: string=\"%s\" n %d \n",str,n);
  145. #endif
  146.  
  147.     if (win == (WINDOW *)NULL)
  148.         return( ERR );
  149.  
  150.     if( n > 0 )
  151.         ic = ((ic<n)?ic:n) - 1;
  152.     else
  153.         ic = ic - 1;
  154.  
  155.     for ( ; ic >= 0; ic-- )
  156.     {
  157.         if (winsch(win, *(str+ic) ) == ERR)
  158.         {
  159.             return( ERR );
  160.         }
  161.     }
  162.     return( OK );
  163. }
  164. /***********************************************************************/
  165. int    mvinsstr(int y, int x, char *str)
  166. /***********************************************************************/
  167. {
  168. #ifdef PDCDEBUG
  169.     if (trace_on) PDC_debug("mvinsstr() - called: y %d x %d string=\"%s\"\n",y,x,str);
  170. #endif
  171.  
  172.     if (stdscr == (WINDOW *)NULL)
  173.         return( ERR );
  174.  
  175.     if (move(y,x) == ERR)
  176.         return( ERR );
  177.  
  178.     return(winsnstr(stdscr,str,(-1)));
  179. }
  180. /***********************************************************************/
  181. int    mvinsnstr(int y, int x, char *str, int n)
  182. /***********************************************************************/
  183. {
  184. #ifdef PDCDEBUG
  185.     if (trace_on) PDC_debug("mvinsnstr() - called: y %d x %d string=\"%s\" n %d \n",y,x,str,n);
  186. #endif
  187.  
  188.     if (stdscr == (WINDOW *)NULL)
  189.         return( ERR );
  190.  
  191.     if (move(y,x) == ERR)
  192.         return( ERR );
  193.  
  194.     return(winsnstr(stdscr,str,n));
  195. }
  196. /***********************************************************************/
  197. int    mvwinsstr(WINDOW *win, int y, int x, char *str)
  198. /***********************************************************************/
  199. {
  200. #ifdef PDCDEBUG
  201.     if (trace_on) PDC_debug("winsstr() - called: string=\"%s\"\n",str);
  202. #endif
  203.  
  204.     if (win == (WINDOW *)NULL)
  205.         return( ERR );
  206.  
  207.     if (wmove(win,y,x) == ERR)
  208.         return( ERR );
  209.  
  210.     return(winsnstr(win,str,(-1)));
  211. }
  212. /***********************************************************************/
  213. int    mvwinsnstr(WINDOW *win,int y, int x, char *str, int n)
  214. /***********************************************************************/
  215. {
  216. #ifdef PDCDEBUG
  217.     if (trace_on) PDC_debug("mvwinsnstr() - called: y %d x %d string=\"%s\" n %d \n",y,x,str,n);
  218. #endif
  219.  
  220.     if (win == (WINDOW *)NULL)
  221.         return( ERR );
  222.  
  223.     if (wmove(win,y,x) == ERR)
  224.         return( ERR );
  225.  
  226.     return(winsnstr(win,str,n));
  227. }
  228.